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1. About this guide 


Objectives and target audience 
This guide describes how to install and configure the Skrill Wordpress module. It assumes that you have 
an existing Wordpress installation. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 


Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 


Menu1 > Menu option2 > Indicates a menu path. 
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2. Introduction 


What is the Wordpress module? 


Wordpress is an eCommerce platform, which provides online merchants with a flexible shopping cart 
system, as well as control over the look-and-feel, content and functionality of their online store. 


Installing and configuring the Skrill Payment Solution module provides a simple, secure and convenient 
option for connecting to Skrill’s online payment processing platform via Wordpress. WooCommerce 
must be installed for this plugin to work. 


Skrill customers using Wordpress have access to a wide range of card and alternative payment methods. 


Signing up for a Skrill account 


Before you can start accepting payments through Skrill, you need to open a free merchant account by 
completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in the your Wordpress backend and start taking payments. 
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3. Installing and configuring Wordpress 


Install Skrill 
Below are describes how to install the plugin and get it working. 
Note: WooCommerce must be installed for this plugin to work. 


1. Upload the content of “copy_this_ to _root_folder_wordpress” to the root directory of your 
wordpress installation, or install the plugin through the WordPress plugins screen directly (by 
compressing in .zip file ‘skrill-woocommerce’ directory). 

2. Activate the plugin through the ‘Plugins’ screen in WordPress 

Use the Settings->Plugin Name screen to configure the merchant account 

4. Navigate to Woocommerce->Settings->Checkout and select the payment method you wish to 
enable in the payment gateway section 


i 


Secret Word and API Password 


It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill Wordpress module. The secret word is used to authenticate the data sent back 


to your Wordpress server after payment. You must obtain the IP address of your Wordpress server to 
configure the API/MQI password. 


You can setup the secret word and API/MQI password as follows: 


1. Log in to your Skrill merchant account at www.skrill.com 

2. Goto Settings > Developer Settings 

3. Set API / MQI Password using the toggle, type and confirm by clicking Save 
4 


If your Magento server has a static IP address, for both the sections specify the IP 
address(es) or IP address range of your Magento server. Access can be granted to: 


e Asingle IP address (e.g. 145.76.160.206 using the example above) 
e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 
e Asubnet in CIDR notation (e.g. 192.168.0.0/24) 
5. Set Secret Word using the toggle, type and confirm by clicking the Save button 


Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase letter, 
and 1 number. 
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API GUIDES O) 





Home Settings 
GY Home Developer Settings 
Configure API and security settings for your wallet account 


AY Transfers 








Bla Bla Wallet 
É Banking ID: 116404455 
@} Balances > Developer Settings : Bla Bla Wallet Hil mu 2 H5 2 = Fi ba Fol 5 25 m 
S All Transactions Wallet IP Whitelisting API / MQI / GSR / CVT Management API Documentation 
& Users 
C) Automated Payment Interface (API) Disabled Ce» 
$ Settings v 
Allow requests to the API only from the following IP addresses. 
& Account Settings Your API secure IP addresses: ( Ê Edit ) ( + Add ) 


£73 Developer Settings 
87.120.141.129 


Wallet Label Settings 


© Merchant Information 


[-) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQ! only from the following IP addresses. 


Your MQI secure IP addresses: ( + Add 


No active secure IP address found 





E) Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses. 





Your GSR secure IP addresses: 


[E] Set API /MQI Password Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 
New Password 


Confirm Password 


[=] SetSecretWord Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


tings | PrivacyNotice | Regulatory Disclosures | Cookie Notice 


© 2020 Paysafe Holdings UK Limited. All rights reserved. Skrill® is a registered trademark of Paysafe Holdings UK Limited. Skrill Limited is registered in England and Wales with company number 04260907 and its registered office at 25 Canada Square, London E14 5LQ. Authorised and regulated by the Financial Conduct 
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Download Skrill on your Wordpress backend 
The next stage of the Wordpress integration is to configure the Wordpress module to connect to your 
Skrill account. The steps are as follows: 


Login to your Wordpress admin account. 

Select Plugins from left hand side menu 

Click on Add new 

Type Skrill in the search bar at top right-hand side 
Click on Install 

Click on Activate 

Once installed configure Skrill settings (Figure 3-2) 


oe a a a a 
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General Products Shipping Payments Accounts & Privacy Emails Integration Advanced Subscriptions Skrill Settings 


Skrill General Setting 


Merchant ID * 00000000 





Your Skrill customer ID. It is displayed in the upper-right corner of your Skrill account. 


Merchant Account (email) * merchant.email@company.com 


Your Skrill account email address. 





Recipient * Merchant Shop 


A description to be shown on Quick Checkout. This can be your company name (max 30 characters) 


Logo Url merchantshoplogo.com 











The URL of the logo which you would like to appear at the top right of the Skrill page. The logo must be accessible via HTTPS or it will not be shown. For best results use logos with dimensions up to 200px in width and 50px in height. 
Shop Url merchantshop.com | 

| 
MQI/API Password * | ta neaseeeceesessscnceneessceeees | 

| 
When enabled, this feature allows you to issue refunds and check transaction statuses. To set it up, you need to login to your Skrill account and go to Settings -> then, Developer Settings. 
* 

Secret word* | semsssssssessessssseemossoeseese 





This feature ts mandatory and ensures the integrity of the data posted back to your servers. To set it up, you need to login to your Skrill account and go to Settings -> then, Developer Settings. 





Display iFrame v 





iFrame — when this option is enabled the Quick Checkout payment form is embedded on your website, Redirect — when this option is enabled the customer is redirected to the Quick Checkout payment form . This option is recommended for 
p: A y J ¢ PY) i F f 


payment options which redirect the user to an external website. 


Merchant Email merchant.email@company.com 





Your email address to receive payment notification 





Transaction Status Completed | Completed v 





How the completed transaction status will be handled by the plugin. 


Figure 3-2: Skrill Settings with example values in Wordpress backend 


Configure Skrill Settings 


Configure the Skrill Settings as follows: 


1. Enter your Skrill Merchant account ID in the Merchant ID field. This is the Customer ID of your 
merchant account 

2. Enter your Skrill Merchant account email address 

3. Either enter a name for your store in the Recipient field to display to customers within the 
Skrill Payment Form 

4. Enter the API password and Secret word that you set up in the previous section 

5. Select a display option for the Skrill Payment Form (Iframe or redirect). See Table 3-1 below 
for a detailed explanation of all Skrill settings 

6. Optional- Enter a URL of a logo to be displayed on the Skrill Payment Form in place of the 
Recipient text. This URL must be in HTTPS format (begin with https://) 


Table 3-1: Skrill Settings 


Your unique merchant identifier. This is the 58010731 
Customer ID of your merchant account. 


The email address linked to your Skrill merchant | techpubs@skrill.com 
account (created by you when you first signed up 
for a Skrill merchant account). 


Merchant ID 


Merchant 


Account (email) 
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Logo URL 


Shop URL 
API Password 


Display 


Optional - A description of your shop. This will Demo Shop 
be displayed on the Skrill Payment Form if you 
do not provide a Logo URL. 


Optional - Link to the URL of a logo, to be https://www.skrill.com/ 
displayed on the Skrill Payment Form. Must be in | fileadmin/content/pdf/ 
HTTPS format. acme.png 





URL for the home page of your shop without the | https://myshop.com 
index.php e.g. if your shop is located at 

https://myshop.com/index.php you would enter 

https://myshop.com 





The API password. This field is mandatory. It 
allows the Wordpress server to receive payment 
information. 


ensures the integrity of the data posted back to 
your Wordpress servers. 





Enter the secret word configured for your Skrill N/A 
account here. This feature is mandatory and 


This setting has two options: IFrame and Redirect | IFrame 
IFrame - when IFrame is enabled the Skrill 
Payment Form is embedded in your shop 
website. See Figure 3-3: for an example. 
Redirect - when redirect is enabled the 
customer is redirected to the Skrill Payment 
Form. This form is displayed on its own in 
the current browser tab. This option is 
recommended if you plan to display 
Payment Methods which redirect the user 
to an external website such as Klarna, 
Rapid Transfer, etc. 


10 
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@ English United Kingdom 


60.QQEvR ° Skrill 


Æp) Skill PAP/0\ meur © 


Card number 


Expiry date Security code 
MM || YY CVV 


Cardholder name 


Type the name exactly as it appears on the card 





PAY NOW 


Cancel 


vi Skrill 


Figure 3-3: Iframe (embedded) option 
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4. Displaying Payment Methods 


You can select the payment methods to display to your customer using the Payment Configuration tab. 
The module has a series of payment method sections for each of the payment methods supported by 
Skrill. An example is displayed in Figure 4-1: 


Aw Skrill - Credit Cards — Credit Cards r @) = Manage 
VISA® a 
nv Skrill - Rapid Transfer — Rapid Transfer @> - 
AAPIDE 
by Skrill 
ANNY Skrill - Klarna — Klarna  @ s = Manage 
cy a 
Av Skrill - Paysafecash — Paysafecash r @) = 


Paysafe:cash 


Figure 4-1: Example Payment method section 


For each payment method, specify whether it should be displayed or not (enabled or not Table 4-1) in 
the list of Payment methods displayed in the Wordpress Checkout. Click on Manage to the right of each 
payment method to see the countries where it is available. See the Skrill Quick Checkout Integration 
Guide for a full list of countries and an up-to-date list of the countries where each payment method is 
supported. The payment methods are displayed in order of popularity in the customer’s country. 


Table 4-1: Payment Method Settings 


Enabled Determines whether this Payment method is displayed - Yes = display, No = 
Do not display. 
Under the Enabled setting is a list of the countries that support this payment 
method. If a Payment method is enabled but the customer’s country is not 


supported (determined by the country set in the billing address the customer 
chose in the Wordpress Checkout) then it will not be shown. 


Show Always set this setting to Yes where available. 
Separately 





Please note that if the payment option is not enabled for your Skrill merchant account, enabling in 
from the backend would not make the payment option visible. You will need to contact 


merchantsupport@paysafe.com in order to discuss activating the specific payment option. 
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All Cards and Alternative Payment Methods 


This special payment option launches the Skrill Payment Form with multiple tabs showing all the 
supported Payment methods available in the customer’s country . The logo for this Payment option in the 
Wordpress Checkout payment information section is as seen in Figure 4-2 below: 


VISA Rapp = All Cards and Alternative Payment Methods Enabled ew 
Miana. ë smyente 


Figure 4-2: Setting up combined Skrill logo 


® English 


60.00EurR o 





Æp] Skeill #4710! 





More payment options 





Figure 4-3: Multiple log 
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5. Customer Experience 


This section describes the customer’s checkout experience when using the Skrill Wordpress module. 


Note: We only describe the Checkout process from the payment selection step onwards as the previous 


steps are unchanged. 


The steps are as follows: 


1. Click a payment method from the list of available payment methods (this list depends on the 
customer’s country, the payment options configured for your Skrill account and the payment 
options configured in the Skrill Wordpress Module 


Billing details 
First name * 


Customer 


Company name (optional) 


Country / Region * 


United Kingdom (UK) 
Street address * 


High Street 10 


Town / City * 


London 


Figure 5-1: 


Your order 
Last name * 
Belt x1 €55,00 
Last name 
Subtotal €55,00 
Shipping Flat rate: €5,00 
Total €60,00 
Skrill 


@ Pay By Skrill [Visa ee æ san 
| Kiarna, è >s sse 


O Skrill Wallet Skri | 


QO Paysafecard @paysafe a 
paycash pay 


sale 


O Credit Cards Vi S A aszercar 


Wordpress Checkout Payment selection showing different payment methods 
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Enter Payment details in the Skrill Payment Form 
@ English United Kingdom 


60.QQEvR ° Skrill 


=p) Skrill 42/01 meur © 





More payment options 





lype the name eè ti ppears on the d 
PAY NOW 
Cancel 





Figure 5-2: Enter Payment Details in the Skrill Payment Form 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display the 
following screen 


® English United Kingdom 


60.QQEvR ® Skrill 


Vf 





Successful payment 





Powered by 
Oem Skrill 
Figure 5-3: Successful Payment 


4. Click Continue to return to the Wordpress Order Confirmation screen. This screen contains 
the unique order number for this payment 
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Order received 


Thank you. Your order has been received. 


e Order number: 394 

e Date: 21 August 2020 

e Total: €60,00 

e Payment method: Pay By Skrill 


Order details 


Product Total 

Belt x 1 €55,00 

Subtotal: €55,00 

Shipping: €5,00 via Flat rate 

Payment method: Pay By Skrill 

Total: €60,00 

Note: Payment Method : Pay By Skrill 


Figure 5-4: Order Confirmation in Wordpress Checkout 
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Removing or reducing the header and reducing the footer 

You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 


footer option on the right). 


© English France 
10.0Q«vr 
O Engish France S English France 
© 

— Pa ea 

-39 =» = 
ciate © = \ 
visa SD 
VISA 
© wusa @9 
Expiry date Security code Expiry date Security code 
MM YY CVV Py ‘St any — Expiry date Security code 
MM YY CVV 
Cardholder name Cardholder name 
First Last First Last Cardholder name 
Firs? Last 
Email address Why ? Email address Why? 
Email address Why? 
PAY NOW PAY NOW 
PAY NOW 
Pomares by Powered by 
Káta Norton s 
Skrill KÁ Skrill Powered by Skrill 


Figure 5-5: Reduced Header and Footer Option 
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6. Payment Information 


The Wordpress module provides payment information in the Order screen with information about the 
payment method used for an order. 


Order #395 details 


e Payment Methods. Paid on 21 August 2020 @ 1:18 pm. Custome 1 1 


General Billing Shipping 











+9253296 


Figure 6-1: Payment Information Example 
The Payment Information section includes the following information: 


The payment option selected in the Wordpress Checkout 

The payment status 

The payment option selected in the Skrill payment form 

The country the payment order originated from. This information is obtained by Geolocation 

using the Customer’s IP address 

5. The country of origin of the payment instrument used (this is only shown for card payment 
methods and bank accounts). For bank accounts, this shows the country where the account is 
registered. For cards, this shows the country where the card was issued 

6. The currency the order was placed in using a 3-digit ISO 4217 currency code e.g. EUR for 

Euros 


DE a 


Update Order 

The Payment Information section also contains an Update Order button on top right-hand side (Figure 
6-2). This button is used to check an order’s payment status with the Skrill Payment Platform and re- 
send a status update. The payment information is then updated. This feature is useful if your Wordpress 
server goes offline or if there is a technical fault with Skrill’s servers which prevents payment status 
updates being sent or received. 
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Order actions à 


Choose an action... 


Move to Trash Update 


Figure 6-2: Update order 








Refunding Payments 
The process for Refunding customer payments is as follows: 
1. Go to Orders in the Wordpress Admin Panel 


2. Search for the customer's invoice using the customer’s order number or name 


#262 test test hd 24 hours ago Pending payment €21,00 
O #261 test test = 24 hours ago Completed €60,00 
#260 test test ka 24 hours ago Completed €15,00 


Figure 6-3: Search for Order 


3. Click the correct Order to view more information 
4. Check that the details are correct. 
5. Select Refund from the menu 


ae Album €15,00 1 €15,00 
SKU: woo-album 
Items Subtotal: €15,00 
Order Total: €15,00 
Paid By Customer: €15,00 
@ This order is no longer editable. 


Figure 6-4: Refund Payment 


6. Type the amount to be refunded 





ae Album €15,00 1 €15,00 
i fo | | 

Restock refunded items: v) 

Amount already refunded: -€0,00 

Total available to refund: €15,00 





@ Reason for refund (optional): | | 


Refund €15,00 manually Refund €15,00 via Skrill - Credit Cards 











Cancel 
Figure 6-5: Refund Payment 


7. Confirmation of a refunded payment 


20 





Skrill Wordpress Module Configuration Guide 1.0 





Items Subtotal: €15,00 
Order Total: €15,00 

Paid By Customer: €15,00 
Refunded: -€15,00 

Net Total: €0,00 


Figure 6-6: Confirmation of a refunded payment 
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7. Testing 


We provide three test cards shown in the table below for use with test merchant accounts. When using 
these card numbers enter an expiry date in the future and a random CVV number. 


Table 7-1: Test Cards 


5438311234567890 


4000001234567890 


Should you wish to test Skrill in DEMO shops please get in touch with Skrill support at 
newbusiness@paysafe.com, so we can provide you with access. 
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